Purpose: This code provides an implementation of the FindFolder toolbox routine which functions correctly in multilingual computing environements. The current implementation assumes the running system software is the same language version as the system software you wish to install and/or the system software you are installing into.
Usage: A header file "FindSpecialFolder.h" is enclosed to #include in your source files, and the object file "FindSpecialFolder.o" is included to compile with your sources. This code is especially useful in action atoms, search procedures, rule functions, and other user-defined installer code resources which currently call FindFolder.
Examples: An example of a situation where this code is useful is if you are shipping software and expect the user to have running system software of one language, but to be installing onto an external hard drive containing a system software in another language. Under this scenario FindFolder will not always return valid information for the special system folders (such as Extensions, Control Panels, etc), as it uses the information in the running System file to locate the special system folder information. FindSpecialFolder, on the other hand, will return the correct information; it will attempt to use the target system information before looking at the running system information.